home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat3 / XmCreatePulldownMenu.z / XmCreatePulldownMenu
Encoding:
Text File  |  2003-11-18  |  5.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu((((3333XXXX))))  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV  XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       _X_m_C_r_e_a_t_e_P_u_l_l_d_o_w_n_M_e_n_u - A RowColumn widget convenience
  10.       creation function
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       #include <Xm/RowColumn.h>
  14.  
  15.       Widget XmCreatePulldownMenu (ppppaaaarrrreeeennnntttt,,,, nnnnaaaammmmeeee,,,, aaaarrrrgggglllliiiisssstttt,,,, aaaarrrrggggccccoooouuuunnnntttt)
  16.            _W_i_d_g_e_t     ppppaaaarrrreeeennnntttt;
  17.            _S_t_r_i_n_g     nnnnaaaammmmeeee;
  18.            _A_r_g_L_i_s_t     aaaarrrrgggglllliiiisssstttt;
  19.            _C_a_r_d_i_n_a_l     aaaarrrrggggccccoooouuuunnnntttt;
  20.  
  21.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.       _X_m_C_r_e_a_t_e_P_u_l_l_d_o_w_n_M_e_n_u creates an instance of a    RowColumn
  23.       widget of type _X_m_M_E_N_U__P_U_L_L_D_O_W_N and returns the associated
  24.       widget ID.  When using this function to create the Pulldown
  25.       MenuPane, a MenuShell    widget is automatically    created    as the
  26.       parent of the    MenuPane. If the widget    specified by the
  27.       ppppaaaarrrreeeennnntttt parameter is a    Popup or a Pulldown MenuPane, the
  28.       MenuShell widget is created as a child of the    ppppaaaarrrreeeennnntttt's
  29.       MenuShell; otherwise,    it is created as a child of the
  30.       specified ppppaaaarrrreeeennnntttt widget.
  31.  
  32.       _X_m_C_r_e_a_t_e_P_u_l_l_d_o_w_n_M_e_n_u is provided as a    convenience function
  33.       for creating RowColumn widgets configured to operate as
  34.       Pulldown MenuPanes and is not    implemented as a separate
  35.       widget class.
  36.  
  37.       A Pulldown MenuPane displays a 3-D shadow, unless the
  38.       feature is disabled by the application.  The shadow appears
  39.       around the edge of the MenuPane.
  40.  
  41.       A Pulldown MenuPane is used when creating submenus that are
  42.       to be    attached to a CascadeButton or a CascadeButtonGadget.
  43.       This is the case for all MenuPanes that are part of a
  44.       PulldownMenu system (a MenuBar), the MenuPane    associated
  45.       with an OptionMenu, and any MenuPanes    that cascade from a
  46.       Popup    MenuPane.  Pulldown MenuPanes that are to be
  47.       associated with an OptionMenu    must be    created    before the
  48.       OptionMenu is    created.
  49.  
  50.       The Pulldown MenuPane    must be    attached to a CascadeButton or
  51.       CascadeButtonGadget that resides in a    MenuBar, a Popup
  52.       MenuPane, a Pulldown MenuPane, or an OptionMenu.  This is
  53.       done by using    the button resource _X_m_N_s_u_b_M_e_n_u_I_d.
  54.  
  55.       A MenuShell widget is    required between the Pulldown MenuPane
  56.       and its parent.  If the application uses this    convenience
  57.       function for creating    a Pulldown MenuPane, the MenuShell is
  58.       automatically    created    as the real parent of the MenuPane;
  59.       otherwise, it    is the application's responsibility to create
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 11/11/03)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu((((3333XXXX))))  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV  XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu((((3333XXXX))))
  71.  
  72.  
  73.  
  74.       the MenuShell    widget.
  75.  
  76.       To function correctly    when incorporated into a menu, the
  77.       Pulldown MenuPane's hierarchy    must be    considered; this
  78.       hierarchy depends on the type    of menu    system that is being
  79.       built    as follows:
  80.  
  81.       +o    If the Pulldown MenuPane    is to be pulled    down from a
  82.            MenuBar,    its ppppaaaarrrreeeennnntttt must    be the MenuBar.
  83.  
  84.       +o    If the Pulldown MenuPane    is to be pulled    down from a
  85.            Popup or    another    Pulldown MenuPane, its ppppaaaarrrreeeennnntttt must be
  86.            that Popup or Pulldown MenuPane.
  87.  
  88.       +o    If the Pulldown MenuPane    is to be pulled    down from an
  89.            OptionMenu, its ppppaaaarrrreeeennnntttt must be the same as the
  90.            OptionMenu parent.
  91.  
  92.       ++++oooo    Specifies the parent widget ID
  93.  
  94.       ++++oooo    Specifies the name of the created widget
  95.  
  96.       ++++oooo    Specifies the argument list
  97.  
  98.       ++++oooo    Specifies the number of attribute/value pairs in    the
  99.            argument    list (aaaarrrrgggglllliiiisssstttt)
  100.  
  101.       PullDown MenuPanes support tear-off capabilities for tear-
  102.       off menus through _X_m_R_o_w_C_o_l_u_m_n    resources.  For    a complete
  103.       definition of    RowColumn and its associated resources,    see
  104.       _X_m_R_o_w_C_o_l_u_m_n(_3_X).
  105.  
  106.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  107.       Returns the RowColumn    widget ID.
  108.  
  109.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  110.       _X_m_C_a_s_c_a_d_e_B_u_t_t_o_n(_3_X), _X_m_C_a_s_c_a_d_e_B_u_t_t_o_n_G_a_d_g_e_t(_3_X),
  111.       _X_m_C_r_e_a_t_e_O_p_t_i_o_n_M_e_n_u(_3_X), _X_m_C_r_e_a_t_e_P_o_p_u_p_M_e_n_u(_3_X),
  112.       _X_m_C_r_e_a_t_e_S_i_m_p_l_e_P_u_l_l_d_o_w_n_M_e_n_u(_3_X), _X_m_M_e_n_u_S_h_e_l_l(_3_X),
  113.       _X_m_R_o_w_C_o_l_u_m_n(_3_X), and _X_m_V_a_C_r_e_a_t_e_S_i_m_p_l_e_P_u_l_l_d_o_w_n_M_e_n_u(_3_X).
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 11/11/03)
  130.  
  131.  
  132.  
  133.